4D Doc Center : CT INSERT EXPRESSION

4D Chart v13

CT INSERT EXPRESSION


CT INSERT EXPRESSION ( area ; alcance ; primer ; ultimo ; expresion ; formato )

Parámetro	Tipo	Descripción
area	Entero largo	Área 4D Chart
alcance	Entero largo	-1 = Primer objeto 0 = Primer objeto de la selección >0 = Objeto ID
primer	Entero	Posición del primer carácter menos 1
ultimo	Entero	Posición del último carácter
expresion	Cadena	Expresión
formato	Cadena	Formato de la expresión

Descripción

El comando CT INSERT EXPRESSION inserta una referencia a expresion en el objeto texto en el Area descrita por alcance.

Si alcance es igual a -1, CT INSERT EXPRESSION inserta la referencia en el primer objeto del documento.
Si alcance es igual a 0, CT INSERT EXPRESSION inserta la referencia en el primer objeto seleccionado.
Si alcance es mayor que 0, debe ser igual al ID de un objeto texto específico y la referencia se inserta dentro de ese objeto texto. Si el objeto no existe, CT INSERT EXPRESSION no hace nada.

Si el objeto descrito por alcance no es un objeto texto, CT INSERT EXPRESSION no hace nada.

primer y ultimo determinan donde se inserta la referencia. primer es uno menos que la posición del primer carácter a reemplazar y ultimo es la posición del último carácter a reemplazar. Si primer es igual a ultimo, ningún carácter se reemplaza y la referencia se inserta entre primer y primer +1. Si ultimo es mayor que el número de caracteres del objeto texto, CT INSERT EXPRESSION reemplaza los caracteres desde primer hasta el final.

expresion es el texto equivalente de toda expresión 4D válida que devuelve un valor. expresion puede ser una referencia a: un campo, una variable, una función 4D, una función usuario (método proyecto), una función externa o una instrucción.

La siguiente tabla muestra ejemplos de cada tipo de expresión:

Ejemplo	Tipo
[Dibujos]Objeto	Campo
vCriteria	Variable
Fecha actual	Función 4D
GetNum	Función definida por el usuario (método proyecto)
CT Count	Función 4D Chart
3 * "Hola"	Instrucción

El parámetro opcional formato es el formato de visualización de la referencia. Este parámetro es equivalente a elegir un formato en la caja de diálogo Formato. Puede hacer referencia a los formatos por su número o por su nombre. Los formatos se numeran en el orden en que aparecen en la lista de la caja de diálogo Formato.

Si formato es una cadena de uno o dos dígitos, entonces el formato aplicado al campo es de la lista. Si formato no es una cadena de uno o dos dígitos, se compara con los valores textos de cada formato en la lista. Si coincide con uno de los valores de la lista, se aplica ese formato. Esto significa que se puede hacer referencia al primer formato de fecha como "19" o "Corto".

Si formato no está en la lista de los formatos, se interpreta como un formato numérico personalizado. Si formato no es apropiado para el valor resultante de la referencia, se ignora. Por ejemplo, si utiliza un formato de fecha para un número, el número aparece sin formato.

Ejemplo

Este ejemplo crea un nuevo objeto texto, lo llena con una referencia a la función 4D Current date y le da formato utilizando el formato Long date.

 $ID :=CT Draw text(Area;0.5;0.5;3.5;1;"Hoy es: ")

 CT INSERT EXPRESSION(Area;$ID;32000;32000;"Fecha actual";"Long")